Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: Scalar parameter docstring and example arguments unused #479

Merged
merged 21 commits into from
Oct 7, 2024

Conversation

maxburs
Copy link
Contributor

@maxburs maxburs commented Aug 22, 2024

  • Fixed scalar parameter docstring and example arguments not passed along when creating ctor versions
  • Improved Playwright config
    • Removed our custom timeout config, which was much lower than the defaults
    • Use recommended reporters in CI (github + html)
    • Upload html report, so we can see why tests failed

@@ -1695,7 +1695,7 @@ class KustoLanguageService implements LanguageService {
const paramSymbol: sym.ScalarSymbol = Kusto.Language.Symbols.ScalarTypes.GetSymbol(
getCslTypeNameFromClrType(param.type)
);
return new sym.ParameterSymbol(param.name, paramSymbol, null);
return new sym.ParameterSymbol(param.name, paramSymbol, param.docstring ?? null);
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tested this change, others are a bit more speculative

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not clear on the use case.
Could we add a unit or integration test to clarify it and help prevent regressions?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Examples and docstring/description are added to tooltips on hover. I'm using them for dashboard system parameters, and and I'd assume other ones are in the system we get from kusto (otherwise, IDK why the C# api would expose it)

Could we add a unit or integration test to clarify it and help prevent regressions?

Unlike a lot of other stuff, this isn't really load bearing. If it breaks it won't block a release. I don't think it should be a priority for testing.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If a unit test would help I might add that, because it would be easy, but I don't think it would do anything useful.

An integration tests would be pretty expensive to add.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm sorry if I wasn't clear.
From my perspective, testing is an important part of our work as engineers.
It helps ensure that what we build remains reliable and understandable for other developers.
I would suggest adding an integration test here, but if that's too difficult, a unit test would also be fine.

Copy link
Contributor

@sagivf sagivf Aug 27, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@maxburs can you add some examples/screenshots of where this shows up and how?
That would help in understanding how/what test we should add.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

image

@maxburs maxburs marked this pull request as ready for review August 22, 2024 03:42
@sagivf
Copy link
Contributor

sagivf commented Sep 5, 2024

@maxburs I'd like this to be tested. This test will easily find other related regressions.

I've opened a task this sprint to complete this task (with an integration test :) )
https://msazure.visualstudio.com/One/_workitems/edit/29323167

@maxburs
Copy link
Contributor Author

maxburs commented Sep 27, 2024

@morgilad Tests added

@morgilad
Copy link
Collaborator

@maxburs the build is failing because of issues with other tests.

@maxburs
Copy link
Contributor Author

maxburs commented Oct 3, 2024

@morgilad CI is passing 🎊

Changes since you last took a look:

  • Removed Playwright timeout config. This was much lower than the defaults; removing it fixed the CI failures.
  • Updated the config to use the github + html reporters in CI
  • Moved the "retain-on-failure" trace config from the cli to the config object
  • Configured CI to upload the html Playwright report

@@ -41,3 +41,11 @@ jobs:
- name: integration tests
working-directory: package
run: yarn test:integration

# https://playwright.dev/docs/ci-intro#html-report
- uses: actions/upload-artifact@v4
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Where can I see this report?

@morgilad morgilad merged commit 45043a1 into master Oct 7, 2024
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants